/** * @desc Creates a plane-shaped {@link Geometry}. * * ## Usage * * Creating a {@link Mesh} with a PlaneGeometry and a {@link PhongMaterial} with diffuse {@link Texture}: * * [[Run this example](http://xeokit.github.io/xeokit-sdk/examples/#geometry_builders_buildPlaneGeometry)] * * ````javascript * import {Viewer, Mesh, buildPlaneGeometry, ReadableGeometry, PhongMaterial, Texture} from "xeokit-sdk.es.js"; * * const viewer = new Viewer({ * canvasId: "myCanvas" * }); * * viewer.camera.eye = [0, 0, 5]; * viewer.camera.look = [0, 0, 0]; * viewer.camera.up = [0, 1, 0]; * new Mesh(viewer.scene, { * geometry: new ReadableGeometry(viewer.scene, buildPlaneGeometry({ * center: [0,0,0], * xSize: 2, * zSize: 2, * xSegments: 10, * zSegments: 10 * }), * material: new PhongMaterial(viewer.scene, { * diffuseMap: new Texture(viewer.scene, { * src: "textures/diffuse/uvGrid2.jpg" * }) * }) * }); * ```` * * @function buildPlaneGeometry * @param {*} [cfg] Configs * @param {Number[]} [cfg.center] 3D point indicating the center position. * @param {String} [cfg.id] Optional ID for the {@link Geometry}, unique among all components in the parent {@link Scene}, generated automatically when omitted. * @param {Number} [cfg.xSize=1] Dimension on the X-axis. * @param {Number} [cfg.zSize=1] Dimension on the Z-axis. * @param {Number} [cfg.xSegments=1] Number of segments on the X-axis. * @param {Number} [cfg.zSegments=1] Number of segments on the Z-axis. * @returns {Object} Configuration for a {@link Geometry} subtype. */ export function buildPlaneGeometry(cfg?: any): any;