Struct Ply

pub struct Ply<E: PropertyAccess> {
    pub header: Header,
    pub payload: Payload<E>,
}

Models all necessary information to interact with a PLY file.

The generic parameter E is the element type used to store the payload data.

Fields

header: Header

All header information found in a PLY file.

payload: Payload<E>

The payloud found after the end_header line in a PLY file.

One line in an ascii PLY file corresponds to a single element. The payload groups elments with the same type together in a vector.

Examples

Assume you have a Ply object called ply and want to access the third point element:

// get ply from somewhere ...
let ref a_point = ply.payload["point"][2];
let ref a_point_x = ply.payload["point"][2]["x"];

Implementations

impl<E: PropertyAccess> Ply<E>

pub fn make_consistent(&mut self) -> Result<(), ConsistencyError>

Takes a mutable Ply object, performs common operations to make it consistent,

When written, a consistent Ply object generates a valid PLY file. This method also checks for invariants that can’t be fixed automatically. If something can not be fixed automatically, it returns a ConsistencyError describing the problem.

Remarks

This method should always be called before writing to a file with Writer. Only exception is write_ply(), which, for convenience, performs the check itself. See write_ply_unchecked() for a variant that expects the client to assure consistency.

No checks on encoding are performed. For maximal compatability, only ascii characters should be used but this is not checked. Every relevant string is checked to not contain line breaks. Identifiers are also checked to not contain white spaces.

impl<E: PropertyAccess> Ply<E>

pub fn new() -> Self

Creates a new Ply<E>.

Trait Implementations

impl<E: Clone + PropertyAccess> Clone for Ply<E>

fn clone(&self) -> Ply<E>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<E: Debug + PropertyAccess> Debug for Ply<E>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<E: PartialEq + PropertyAccess> PartialEq for Ply<E>

fn eq(&self, other: &Ply<E>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<E: PropertyAccess> StructuralPartialEq for Ply<E>