fougue / mayo

3D CAD viewer and converter based on Qt + OpenCascade
BSD 2-Clause "Simplified" License
1.45k stars 276 forks source link
3d-graphics 3d-viewer brep cad converter converter-cli dxf fbx gltf gltf-viewer iges meshviewer opencascade ply pointcloud qt5 step stl vrml wavefront-obj
[![Windows CI](https://github.com/fougue/mayo/actions/workflows/ci_windows.yml/badge.svg?branch=develop)](https://github.com/fougue/mayo/actions/workflows/ci_windows.yml) [![Linux CI](https://github.com/fougue/mayo/actions/workflows/ci_linux.yml/badge.svg?branch=develop)](https://github.com/fougue/mayo/actions/workflows/ci_linux.yml) [![macOS CI](https://github.com/fougue/mayo/actions/workflows/ci_macos.yml/badge.svg?branch=develop)](https://github.com/fougue/mayo/actions/workflows/ci_macos.yml) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/d51f8ca6fea34886b8308ff0246172ce)](https://app.codacy.com/gh/fougue/mayo/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) [![Downloads](https://img.shields.io/github/downloads/fougue/mayo/total.svg)](https://github.com/fougue/mayo/releases) [![Version](https://img.shields.io/badge/version-v0.8.0-blue.svg?style=flat)](https://github.com/fougue/mayo/releases)
Logo

Mayo the opensource 3D CAD viewer and converter

:eyeglasses: Overview

For more details have a look at this fine review Introducing Mayo by Libre Arts
There's also a complete video on YouTube

:zap: Features

:floppy_disk: Supported formats

Format Import Export Notes
STEP :white_check_mark: :white_check_mark: AP203, 214, 242
IGES :white_check_mark: :white_check_mark: v5.3
BREP :white_check_mark: :white_check_mark: OpenCascade format
DXF :white_check_mark: :x:
OBJ :white_check_mark: :white_check_mark:
glTF :white_check_mark: :white_check_mark: 1.0, 2.0 and GLB
VRML :white_check_mark: :white_check_mark: v2.0 UTF8
STL :white_check_mark: :white_check_mark: ASCII/binary
AMF :white_check_mark: :white_check_mark: v1.2 Text/ZIP(export)
PLY :white_check_mark: :white_check_mark: ASCII/binary
OFF :white_check_mark: :white_check_mark:
3MF :white_check_mark: :x:
3DS :white_check_mark: :x:
FBX :white_check_mark: :x:
Collada :white_check_mark: :x:
X3D :white_check_mark: :x:
X(DirectX) :white_check_mark: :x:
Image :x: :white_check_mark: PNG, JPEG, ...

See also this dedicated wikipage for more details

:mag: 3D viewer operations

Operation Mouse/Keyboard controls
Rotate mouseLeft + move
Pan mouseRight + move
Zoom mouseLeft + mouseRight + move
Zoom +/- mouseWheel(scroll)
Window zoom CTRL + mouseLeft + move
Instant zoom spaceBar
Select Object mouseLeft click
Select Objects SHIFT + mouseLeft clicks

Mayo supports also multiple 3D viewer navigation styles to mimic common CAD applications(CATIA, SOLIDWORKS, ...)

:package: Install

Release packages are available for Windows and Linux on the Releases page.

Alternatives for Windows:

:hammer: How to build

Instructions for Windows
Instructions for Linux
Instructions for macOS

:clapper: Gallery

Easy to use command-line utility for batch conversion of CAD files

Import of glTF file with textures

Import of STEP file with many parts

Import of PLY file defining point cloud

Options dialog with import/export configuration per CAD format

Home page with quick access to recent files