.. _reference:

Reference
=========

The `DXF Reference`_ is online available at `Autodesk`_.

Quoted from the original DXF 12 Reference which is not available on the web:

   Since the AutoCAD drawing database (.dwg file) is written in a
   compact format that changes significantly as new features are added
   to AutoCAD, we do not document its format and do not recommend that
   you attempt to write programs to read it directly. To assist in
   interchanging drawings between AutoCAD and other programs, a Drawing
   Interchange file format (DXF) has been defined. All implementations
   of AutoCAD accept this format and are able to convert it to and from
   their internal drawing file representation.

DXF Document
------------

.. toctree::
    :maxdepth: 2

    drawing/management
    drawing/drawing
    drawing/recover
    r12strict

DXF Structures
--------------

.. toctree::
    :maxdepth: 2

    sections/index
    tables/index
    blocks/index
    layouts/index
    groups
    dxfentities/index
    dxfobjects/index
    xdata
    appdata
    xdict
    reactors
    blkrefs
    const

Colors
------

.. toctree::
    :maxdepth: 1

    colors

Enums
-----

.. toctree::
    :maxdepth: 1

    enums


Math
----

.. toctree::
    :maxdepth: 2

    math/core
    math/clipping
    math/clustering
    math/linalg
    math/rtree
    math/triangulation

.. The borders between the "Construction" and the "Tools" section are blurry!

Construction
------------

.. Tools that alter the geometry of entities or create new entities.

.. toctree::
    :maxdepth: 1

    acis
    bbox
    disassemble
    edgeminer
    edgesmith
    math_construction_tools
    path
    reorder
    transform
    upright

Custom Data
-----------

.. toctree::
    :maxdepth: 1

    user_xdata
    user_record

Fonts
-----

.. toctree::
    :maxdepth: 2

    tools/fonts

Tools
-----

.. Tools that alter the visual appearance of entities or the DXF document itself.
   Tools that work with entities.

.. toctree::
    :maxdepth: 2

    tools/appsettings
    tools/comments
    tools/gfxattribs
    tasks/groupby
    tools/query
    tools/revcloud
    tasks/select
    tools/text
    tools/text_size
    tools/xclip
    tools/zoom
    render/index

**TODO:**

- ACAD_TABLE helper tools
- Dynamic Block helper tools


Global Options
--------------

.. toctree::
    :maxdepth: 1

    options

For Developers
--------------

.. toctree::
    :maxdepth: 2

    dxfinternals/index
    low_level_tools/functions
    low_level_tools/dxf_unicode_decoder
    low_level_tools/sat_crypt
    develop/index


.. _DXF Reference: http://docs.autodesk.com/ACD/2014/ENU/index.html?url=files/GUID-235B22E0-A567-4CF6-92D3-38A2306D73F3.htm,topicNumber=d30e652301
.. _Autodesk: http://usa.autodesk.com/