1.. _readers.obj:
2
3readers.obj
4===============
5
6The **OBJ reader** reads data from files in the OBJ format.
7This reader constructs a mesh from the faces specified in the OBJ file, ignoring
8vertices that are not associated with any face. Faces, vertices, vertex normals and vertex
9textures are read, while all other obj elements (such as lines and curves) are ignored.
10
11.. plugin::
12
13Example
14-------
15This pipeline reads from an example OBJ file outputs
16the vertices as a point to a LAS file.
17
18.. code-block:: json
19
20    [
21        {
22            "type": "readers.obj",
23            "filename": "test/data/obj/1.2-with-color.obj"
24        },
25        {
26            "type" : "writers.las",
27            "filename": "output.las",
28            "scale_x": 1.0e-5,
29            "scale_y": 1.0e-5,
30            "scale_z": 1.0e-5,
31            "offset_x": "auto",
32            "offset_y": "auto",
33            "offset_z": "auto"
34        }
35    ]
36
37
38Options
39-------
40
41.. include:: reader_opts.rst
42
43filename
44  File to read. [Required]