shapes

Shapes

Since R2025a

collapse all in page

    Syntax

    s = shapes(layerobj)

    Description

    s = shapes(layerobj) returns the shape structure of a layer object which includes Surfaces, Pins, Vias, and Traces.

    example

    Examples

    collapse all

    Open Live Script

    Read-in a pcb file

    Use the pcbFileRead object to read in a file. Accepted file formats are:

    • ODB++

    • Allegro

    • Native

    Here we are using a native format file 

    pfile = pcbFileRead('native_ExampleBoard_Allegro')
    pfile = 
  pcbFileRead with properties:

           FileName: 'native_ExampleBoard_Allegro'
          NumLayers: 5
         MetalLayer: [1 3 5]
    DielectricLayer: [2 4]
        LayerHeight: [0.0184 0.0104 0.0092 0.0012 0]
         NumCadnets: 7
       NumPadStacks: 6
      NumComponents: 8
           NumParts: 5

    Create a layer object

    Create a layer object of metal layer 1 for all pcb entities

    layerobj = layer(pfile,1)
    layerobj = 
  layer with properties:

        pcBoard: [1×1 pcbFileRead]
    LayerNumber: 1
           Type: 'Pin'
    LayerHeight: 0.0184
    NumSurfaces: 1
        NumPins: 14
        NumVias: 4
      NumTraces: 21
     EntityList: [1×1 struct]

    Get the layer shapes

    Use the shapes function

    shapes(layerobj)
    ans = struct with fields:
    Surfaces: [1×1 antenna.Polygon]
        Pins: [1×14 antenna.Polygon]
        Vias: [1×4 antenna.Polygon]
      Traces: [1×21 antenna.Polygon]

    Input Arguments

    collapse all

    The input specified as a layer object.

    Example: s = shapes(layername)

    Data Types: string

    Output Arguments

    collapse all

    s is returned as a structure with fields showing the shapes in the layer object.

    Version History

    Introduced in R2025a