Video fusion layer (GeoVideoLayer)

method

addVideoCameras

Add a virtual camera corresponding to the video according to the camera parameters. Obtaining camera parameters requires relying on video calibration tools. For details, please contact customer service (lower right corner).

Parameters

Name	Type	Description
cameraData	Object/Array[Object]	RequiredCamera parameter object or object group that needs to be added. name type default value description videoUrl String RequiredCamera resource file path. far Number RequiredFar plane, the value is a positive number, and near < far. fov Number RequiredField of view angle, radian value, range: (0, π). heading Number RequiredCamera azimuth angle, radian value, range: [-π, π]. width Number RequiredVideo width, the value is a positive number. height Number RequiredVideo height, the value is a positive number. name String RequiredCamera name. near Number RequiredNear plane, the value is a positive number. pitch Number RequiredCamera pitch angle, radian value, range: [0, π]. position Array RequiredCamera position information, three-dimensional array, such as [x, y, z]. roll Number RequiredCamera roll angle, radian value, range: [-π, π]. aspect Number width/height optionalCamera aspect ratio, the value is a positive number. maskBox Array[Number] [0,1,0,1] optionalCrop the video frame range. Array representation: [xMin, xMax, yMin, yMax], the starting point is the lower left corner, xMin, xMax represent the starting point proportion and end point proportion of the video horizontal cropping, yMin, yMax represent the starting point proportion and end point proportion of the video vertical direction cropping, the parameter value range is 0-1, and xMin < xMax, yMin < yMax. cameraModel Number 0 optionalDistortion correction type, 0 means no distortion correction, 1 means fisheye distortion correction, 12 means division model distortion correction. depthTest Boolean true optionalWhether to enable depth testing. factor Number 0 optionalFactor, the value is an integer greater than or equal to 0. fx Number 0 optionalDistortion correction parameter, value is greater than 0. fy Number 0 optionalDistortion correction parameter, value is greater than 0. k1 Number 0 optionalDistortion correction parameter, the value is a rational number. k2 Number 0 optionalDistortion correction parameter, the value is a rational number. k3 Number 0 optionalDistortion correction parameter, the value is a rational number. k4 Number 0 optionalDistortion correction parameter, the value is a rational number. p1 Number 0 optionalDistortion correction parameter, the value is a rational number. p2 Number 0 optionalDistortion correction parameter, the value is a rational number. units Number 0 optionalUnit, the value is an integer greater than or equal to 0. u0 Number optionalDistortion correction parameter, value is greater than 0. videoType Number 1 optionalVideo source format, 0 means mp4 format, 1 means img, 2 means flv. v0 Number optionalDistortion correction parameter, value is greater than 0. zThreshold Number 0 optionalz offset, value is greater than or equal to 0. limitHeight Number undefined optionalCrop the projected video according to the specified height in the three-dimensional space. The default is not to crop, and the value is greater than or equal to 0. fScale Number 1 optionalView scaling coefficient, the value is a positive number, the default is 1, no scaling, when it is less than 1, the viewing angle increases, when it is greater than 1, the viewing angle decreases. cropRange Array [] optionalThe cropping range array of the video screen, retaining the video content within the cropping range, with the lower left corner of the video screen as the coordinate origin [0,0], the X axis is positive to the right, the Y axis is positive upward, the value range is 0-1, and the upper right corner is [1,1]. colorBalance Array [] optional3×4 color correction matrix used for color uniformity, represented by a two-dimensional array, in the shape of [ [ a1, a2, a3, a4], [b1, b2, b3, b4], [c1, c2, c3, c4]].

getViewPoint

Get the view point of the current window. The return value can be used in the setViewPoint interface.

setVideoCameraActiveByIndex

Set the camera to start based on the index.

Parameters

Name	Type	Description
active	Boolean	RequiredSet the opening and hiding of the camera screen, true means opening.
index	Number	RequiredCamera index sequence.

Case

        let models_geo = ["ATModelNew.glb"].map(item => ({
            type: 'glb',
            url: "../example_data/aoti_models/" + item
        }));
        let options = {
                id: 'model_id1',
                type: 'geoVideo',
                models: models_geo,
                center: [120.744471002000068, 31.306768408000039, 3.617],
                project: "3857",
                cameraData: cameraData,
                callback: function (geoVideo) {
                    GeoVideo = geoVideo;
                }
            }
        map.addLayer(options);

        map.on('click', function (e) {
            GeoVideo.setVideoCameraActiveByIndex(0, true);
            GeoVideo.setViewPoint(viewData)
        })

Refer to Example.

setViewPoint

Set the map viewshed based on viewpoint information.

Parameters

Name	Type	Description
viewData	Object	RequiredViewpoint information object. name type default value description heading Number RequiredView point azimuth angle radian value, range: [-π, π]. pitch Number RequiredView point pitch angle, radian value, range: [0, π]. position Array RequiredViewpoint position information, three-dimensional array, such as [x, y, z]. roll Number RequiredView point roll angle, radian value, range: [-π, π]. isLLH Boolean false optionalWhether the viewpoint position is expressed in longitude and latitude, true indicates longitude and latitude.

setCropRangeByIndex

Set the cropping range of the video screen according to the index. For details, please refer to Example.

Parameters

name	type	default value	description
index	Number		RequiredCamera index sequence.
cropRange	Array	[]	optionalThe crop range array of the video screen, retaining the video content within the crop range, with the lower left corner of the video screen as the coordinate origin [0,0], the X axis is positive to the right, the Y axis is positive upward, the value range is 0-1, and the upper right corner is [1,1].

Case

let options = {
    id: 'model_id1',
    type: 'geoVideo',
    cameraData: [{...},{...},...],
    callback: function (geoVideo) {
        GeoVideo = geoVideo;
    }
}
map.addLayer(options);
//Set the cropping range of the first video
GeoVideo.setCropRangeByIndex(0, [[0.1,0.1],[0.8,0.1],[0.8,0.8],[0.1,0.8]]);

setColorBalanceByIndex

Set the color correction matrix of the video image according to the index. For details, please refer to Example.

Parameters

name	type	default value	description
index	Number		RequiredCamera index sequence.
colorBalance	Array	[]	optionalA 3×4 color correction matrix for color balancing, represented by a two-dimensional array, in the shape of [ [ a1, a2, a3, a4], [b1, b2, b3, b4], [c1, c2, c3, c4]]. By default, an empty array means no color balancing is performed.

Case

let options = {
    id: 'model_id1',
    type: 'geoVideo',
    cameraData: [{...},{...},...],
    callback: function (geoVideo) {
        GeoVideo = geoVideo;
    }
}
map.addLayer(options);
//Set the color correction matrix of the first video
GeoVideo.setColorBalanceByIndex(0, [[0.5,0.5,0.5,0.5],[0.5,0.5,0.5,0.5],[0.5,0.5,0.5,0.5]]);