Struct gds21::GdsLibrary

pub struct GdsLibrary {

    pub name: String,
    pub version: i16,
    pub dates: GdsDateTimes,
    pub units: GdsUnits,
    pub structs: Vec<GdsStruct>,
    pub libdirsize: Unsupported,
    pub srfname: Unsupported,
    pub libsecur: Unsupported,
    pub reflibs: Unsupported,
    pub fonts: Unsupported,
    pub attrtable: Unsupported,
    pub generations: Unsupported,
    pub format_type: Unsupported,
}

Gds Library

The Library is GDSII’s primary idiom for a suite of layout-cells. A Library generally corresponds one-to-one with a .gds file. Libraries consist primarily of cell-definitions (GdsStructs), and secondarily include library-level meta-data, including the distance units, GDS-spec version, and modification dates.

Several more esoteric library-level GDSII features are included as GdsLibrary fields, but are not materially supported. The empty Unsupported value generally denotes these fields.

Spec BNF:

HEADER BGNLIB [LIBDIRSIZE] [SRFNAME] [LIBSECUR] LIBNAME [REFLIBS] [FONTS] [ATTRTABLE] [GENERATIONS] [<FormatType>]
UNITS {<structure>}* ENDLIB

Fields

name: String

Library Name

version: i16

Gds Spec Version

dates: GdsDateTimes

units: GdsUnits

Spatial Units

structs: Vec<GdsStruct>

Struct Definitions

libdirsize: Unsupported

srfname: Unsupported

libsecur: Unsupported

reflibs: Unsupported

fonts: Unsupported

attrtable: Unsupported

generations: Unsupported

format_type: Unsupported

Implementations

impl GdsLibrary

pub fn new(name: impl Into<String>) -> Self

Create a new and empty GdsLibrary

pub fn load(fname: impl AsRef<Path>) -> GdsResult<GdsLibrary>

Read a GDS loaded from file at path fname

pub fn from_bytes(bytes: Vec<u8>) -> GdsResult<GdsLibrary>

Read a GdsLibrary from byte-vector bytes

pub fn stats(&self) -> GdsStats

Collect and return the library’s aggregate statistics (numbers of structs, elements by type)

pub fn save(&self, fname: impl AsRef<Path>) -> GdsResult<()>

Save to file fname

pub fn write(&self, file: impl Write) -> GdsResult<()>

Write to file file

Trait Implementations

impl Clone for GdsLibrary

fn clone(&self) -> GdsLibrary

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GdsLibrary

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

Formats the value using the given formatter.

impl Default for GdsLibrary

fn default() -> GdsLibrary

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GdsLibrary

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl PartialEq<GdsLibrary> for GdsLibrary

fn eq(&self, other: &GdsLibrary) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl SerdeFile for GdsLibrary

fn save(
    &self,
    fmt: SerializationFormat,
    fname: impl AsRef<Path>
) -> Result<(), Error>

Save in fmt-format to file fname

fn open(
    fname: impl AsRef<Path>,
    fmt: SerializationFormat
) -> Result<Self, Error>

Open from fmt-format file fname

impl Serialize for GdsLibrary

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GdsLibrary