WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

OFF (.off, .coff)

  • Import and Export support ASCII and binary versions of the OFF file format.

Background & Context

    • OFF 3D geometry format.
    • Used for storing and exchanging 3D models.
    • OFF is an acronym for Object File Format.
    • Occasionally called COFF if color information is present.
    • Related to NOFF and CNOFF.
    • ASCII or binary format.
    • Represents a single 2D or 3D object.
    • Stores a collection of planar polygons with possibly shared vertices.
    • Supports polygon and vertex colors and opacity specifications.

Import & Export

  • Import["file.off"] imports an OFF file as a MeshRegion object representing the surface.
  • Import["file.off",elem] imports the specified element from an OFF file.
  • The import format can be specified with Import["file","OFF"] or Import["file",{"OFF",elem,…}].
  • Export["file.off",expr] exports a 3D mesh-based geometric region to a binary OFF file. The expr can be any region that is ConstantRegionQ or a Graphics or Graphics3D object.
  • Export["file.off",expr,{opt1->val1,…}] exports expr with the specified options for the file format.
  • The export format can be specified with Export["file",expr,"OFF"] or Export["file",expr,{"OFF",opt1->val1,…}].
  • See the following reference pages for full general information:
  • Import, Exportimport from or export to a file
    CloudImport, CloudExportimport from or export to a cloud object
    ImportString, ExportStringimport from or export to a string
    ImportByteArray, ExportByteArrayimport from or export to a byte array

Import Elements

  • General Import elements:
  • "Elements" list of elements and options available in this file
    "Summary"summary of the file
    "Rules"list of rules for all available elements
  • Data format representation elements:
  • "BinaryFormat"whether the file is a binary or ASCII OFF
    "VertexData"list of vertex coordinates
    "PolygonData"the polygon elements in indexed form
    "VertexColors"colors associated with each vertex
    "PolygonColors"face color information for each polygon
  • Geometry representation elements:
  • "BoundaryMeshRegion"boundary mesh representation of the solid
    "MeshRegion"mesh representation of the surface
  • Graphics representation elements:
  • "Graphics"2D OFF file represented as a Graphics object
    "Graphics3D"3D geometry represented as a Graphics3D object
    "GraphicsComplex"OFF file as a GraphicsComplex object
    "PolygonObjects"list of Polygon primitives given in absolute coordinates

Options

  • Export options:
  • "BinaryFormat"Truewhether to write a binary or ASCII file

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Import a 3D model from OFF as a MeshRegion object:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-nj1
Out[1]=1

Summary properties of the model:

In[2]:=2
✖
https://wolfram.com/xid/0ev7hjju-vffzae
Out[2]=2

Export a 3D model to an OFF file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-yup2m
Out[1]=1

Print the raw textual contents of the file:

In[2]:=2
✖
https://wolfram.com/xid/0ev7hjju-d92707

Scope  (13)Survey of the scope of standard use cases

Import  (7)

Import works on an ASCII OFF file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-d12jk4
Out[1]=1

Binary OFF file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-cv8yfp
Out[1]=1

Any accessible URL:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-gleixe
Out[1]=1

Stream:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-tgzw4
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0ev7hjju-care6j
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0ev7hjju-ll8we5
Out[3]=3

Import automatically detects OFF files:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-pbu2ww
Out[1]=1

Import provides access to elements in the OFF file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-eqy06y
Out[1]=1

Import works on large files:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-jnqgot
Out[1]=1

Export  (6)

Export works on 3D graphics:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-5qjue
Out[1]=1

Special regions:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-jkpjvf
Out[1]=1

Formula regions:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-26h70
Out[1]=1

Mesh regions:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-d1c9he
Out[1]=1

Export to a binary OFF file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-dnnsik
Out[1]=1

ASCII OFF file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-eu59om
Out[1]=1

Import Elements  (11)

"BinaryFormat"  (1)

Test whether this file is a binary or ASCII OFF:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-dz5u7n
Out[1]=1

"BoundaryMeshRegion"  (1)

Give a boundary mesh region:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-gyajux
Out[1]=1

"CoordinateTransform"  (1)

The coordinate system used by the OFF format is identical to the Wolfram Language:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-h1eekg
Out[1]=1

"Graphics3D"  (1)

Give the Graphics3D object:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-gtkztu
Out[1]=1

"GraphicsComplex"  (1)

Give the GraphicsComplex object:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-cfa48d
Out[1]=1

"MeshRegion"  (1)

Give a mesh region:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-n1hu8w
Out[1]=1

"PolygonColors"  (1)

Give the polygon colors:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-jzqep

"PolygonData"  (1)

Give the polygon elements in indexed form:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-nr8wmc
Out[1]=1

"PolygonObjects"  (1)

Give the list of Polygon primitives given in absolute coordinates:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-ck7dza
Out[1]=1

"Summary"  (1)

Give the summary of properties:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-bpbyoi
Out[1]=1

File size:

In[2]:=2
✖
https://wolfram.com/xid/0ev7hjju-dfva2d
Out[2]=2

"VertexData"  (1)

Give the vertex coordinates:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-gcs90j

Export Options  (2)

By default, a binary file is generated when exporting:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-nz2p4
Out[1]=1

Print the raw textual contents of the file:

In[2]:=2
✖
https://wolfram.com/xid/0ev7hjju-dz5u9y

Use "BinaryFormat" False to generate an ASCII file:

In[1]:=1
✖
https://wolfram.com/xid/0ev7hjju-1q31y
Out[1]=1

Print the raw textual contents of the file:

In[2]:=2
✖
https://wolfram.com/xid/0ev7hjju-c925ta