Struct PointCloudEncoder 

pub struct PointCloudEncoder { /* private fields */ }

Available on crate feature encoder only.

Encoder for Draco point cloud bitstreams.

A PointCloudEncoder takes a PointCloud plus EncoderOptions and writes a .drc bitstream into an EncoderBuffer. Depending on the options it uses either KD-tree or sequential attribute encoding, matching C++ Draco’s PointCloudEncoder selection.

Examples

use draco_core::{
    DataType, DecoderBuffer, EncoderBuffer, EncoderOptions, GeometryAttributeType,
    PointAttribute, PointCloud, PointCloudDecoder, PointCloudEncoder,
};

// Three points with float32 positions.
let mut pc = PointCloud::new();
let mut position = PointAttribute::new();
position.init(GeometryAttributeType::Position, 3, DataType::Float32, false, 3);
let coords: [f32; 9] = [0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0, 0.0];
for (i, value) in coords.iter().enumerate() {
    position.buffer_mut().write(i * 4, &value.to_le_bytes());
}
pc.add_attribute(position);

// Encode, then decode it back.
let mut encoder = PointCloudEncoder::new();
encoder.set_point_cloud(pc);
let mut buffer = EncoderBuffer::new();
encoder.encode(&EncoderOptions::new(), &mut buffer)?;

let mut decoded = PointCloud::new();
PointCloudDecoder::new().decode(&mut DecoderBuffer::new(buffer.data()), &mut decoded)?;
assert_eq!(decoded.num_points(), 3);

Implementations

impl PointCloudEncoder

pub fn new() -> Self

Creates an encoder without an assigned point cloud.

pub fn point_cloud(&self) -> Option<&PointCloud>

Returns the point cloud assigned to this encoder, if any.

pub fn set_point_cloud(&mut self, pc: PointCloud)

Assigns the point cloud to encode.

pub fn encode( &mut self, options: &EncoderOptions, out_buffer: &mut EncoderBuffer, ) -> Status

Encodes the assigned point cloud into an output buffer.

A point cloud must have been provided with set_point_cloud first.

Errors

Returns an error if no point cloud was set, the options are unsupported, or attribute encoding fails.

pub fn get_geometry_type(&self) -> EncodedGeometryType

Returns the geometry type produced by this encoder.

Trait Implementations

impl Default for PointCloudEncoder

fn default() -> Self

Returns the “default value” for a type.

impl GeometryEncoder for PointCloudEncoder

fn point_cloud(&self) -> Option<&PointCloud>

Returns point-cloud geometry when available.

fn mesh(&self) -> Option<&Mesh>

Returns mesh geometry when available.

fn corner_table(&self) -> Option<&CornerTable>

Returns mesh corner-table topology when available.

fn options(&self) -> &EncoderOptions

Returns the active encoder options.

fn get_geometry_type(&self) -> EncodedGeometryType

Returns the encoded geometry type.

fn get_encoding_method(&self) -> Option<i32>

Returns the forced encoding method, if one is active.

fn get_data_to_corner_map(&self) -> Option<&[u32]>

Returns a data-to-corner map for mesh attribute prediction, if present.

fn get_vertex_to_data_map(&self) -> Option<&[i32]>

Returns a vertex-to-data map for mesh attribute prediction, if present.