On Oct 1, 2020 this repository, including issues and pull requests, will be archived and transferred to gitlab.com. In order for your pull requests and issues to be imported into GitLab you must set your email address on GitHub to public and use the same address for your GitLab account. Or login to GitLab at least once using the GitHub icon. Otherwise the importer can't correlate the account information and the issues/comments on GitLab will be owned by kicad-bot (importer documentation).
This repository contains 3D models for rendering and MCAD integration, for use with KiCAD EDA software. The model needs a mechanical model source (a manually-modelled or script-generated file); its WRL counterpart file must be obtained as a conversion from the MCAD model
The 3D model library supports two file formats:
STEP files are used for integration with MCAD software packages.
STEP models must be 1:1 in mm, better if the model is a solid single object (a union of parts) for size and loading optimization. KiCad supports STEP file integration and can export board and component models into an integrated STEP file. This file can then be imported by a MCAD package.
WRL files must be exported from its mechanical model counterpart. WRL files are used for photo-realistic rendering using KiCad's raytracing rendering engine. This format supports more complex material properties, allowing various common component materials to be accurately rendered.
Source files for generated models should be submitted to (https://github.com/kicad/packages3d-source). This includes generator scripts, or native model files from source software (e.g. FreeCAD)
The model has to be created in a mechanical program, able to generate STEP export. The model can be created by automatic scripts or manually. FreeCAD is the preferred software because it is open source, and anyone can rework the model for future improvements, but also other proprietary MCAD software are allowed. In case the model is generated by scripts, the scripts should be linked to the PR stating sw and version used to run the scripts; when the model is manually created, the MCAD source file should be added to the PR as well as STEP file. STEP models should be 1:1 in mm, better if the model is a solid single object (a union of parts) for size and loading optimization; text is not suggested on models because of size increasing, anyway in case of text the fonts must be licensed free as the word. WRL models should be exported from its mechanical counterpart and, when possible, have the suggested material properties as in these documents:
A simple method to export a fully compliant WRL model from a mechanical STEP model is through KiCad StepUp.
A tutorial video can be found here
A good starting point to learn how to create models by script is this github repo kicad-3d-models-in-freecad.
The scripts are made in Python and run in FreeCAD with CadQuery module add-on.
The 3D models in this library are aligned with the footprints available in the KiCad footprint libraries.
- The STEP file format includes model scaling information, and so the 3D model scaling parameter must always be set to 1:1 in mm
- The WRL file format does not specify absolute dimensions. KiCad normalizes WRL model dimension to units of 0.1 Inches, and the internal units of the WRL files should be scaled accordingly
Refer to the Wiki page on Contributing
Refer to the LICENSE.md file
In addition to the 3D model data provided in this library, there are other sources that designers may use to source 3D models.
- Many manufacturers provide accurate 3D models for specific components.
- Online repositories, e.g.
Ensure that the LICENSE of any 3D data used is compatible with the intended use-case of the project.