Creamy 3D is a library that allows seamless integration of simple 3D objects into your SwiftUI projects. Spice up your app's UI with interactive icons and 3D visuals. Its material system draws inspiration from Spline.design.
CreamyView {
Mesh(source: .stl("order")) {
MatcapMaterial(name: "matcap")
}
.resizable()
.scaledToFit()
}
To infuse a model into your scene, simply start with CreamyView. This view adopts the size of its parent container and expects a model builder as an input argument. With a design principle that mirrors SwiftUI's Image modifiers, interacting with your model feels natural and intuitive. For instance, the .resizable() modifier scales your model to occupy the entire container space.
- File Support: Currently, only the STL and OBJ file formats are supported.
- Camera Details: An orthographic camera is calibrated to the view size and coordinated like its SwiftUI counterpart.
- Mesh Information: The library leans on ModelIO for both model loading and generation.
- Rendering: Rendering is based on Metal with MetalKit.
The material system is inspired by spline.design, so the goal is to make any visual appearance reproducible by the library.
| Materials | Status | Comment |
|---|---|---|
| Color | ✅ done | |
| Matcap | ✅ done | |
| Fresnel | 🟡 partially done | Factor is missing. The result doesn't match precisely with spline.design |
| Texture | 🟡 partially done | Currently only samples based on UV |
| Light | ⚙ in progress | |
| Normal | todo | |
| Depth | todo | |
| Gradient | todo | |
| Noise | todo | |
| Rainbow | todo | |
| Outline | todo | |
| Glass | todo | |
| Pattern | todo |
The library provides some basic primitive shapes, but making the shape generation more advanced is not planned so far. The main focus will be on rendering models from files.
| Meshes | Status |
|---|---|
| Sphere | ✅ done |
| Cube | ✅ done |
| Model | 🟡 partially done |
| Plane | todo |
| Cylinder | todo |
| Cone | todo |
| ... | todo |
The most common post-processing effects are planned. The list is not full yet.
| Post processing | Status |
|---|---|
| Bloom | todo |
| Aberration | todo |
| ... | todo |
-
Scene background customization.(Just use.backgroundof the View) - Modifiers:
offset,rotation. - Modifiers:
frameandpadding. - Materials composition
- Add materials:
fresnel,texture - Blend modes:
multiply,screen,overlay - Add
lightmaterial - Animations support out of the box (Currently supported using Animatable modifier on the parent View)
- Multiple Meshes support
- Bloom effect support
- Split Mesh into separate types, like "Sphere(), Cube(), Model()"
- Add ability to apply separate materials to submeshes
- Add Scene type which can handle adding USD
CreamyView {
Scene(name: "my_scene.usdz") {
Object(name: "my object") { // Define materials for the object named "my object"
ColorMaterial(color: .white)
LightMaterial(type: .physical) {
DirectionalLight(direction: .init(x: 1.0, y: 1.0, z: 0.0))
}
}
}
}- Material transition animations
- Clonner, which repeats Meshes. Example:
Clonner(.grid(.init(x: 10, y: 10, z: 10)), spacing: 16.0) {
Mesh(source: .sphere)
.resizable()
.frame(width: 50.0, height: 50.0)
}- Animated material transitions. The interface is under consideration. One option is:
Mesh(source: .sphere) {
Transition(.fade, value: isSwitched) { value in
if value {
ColorMaterial(color: .red)
} else {
ColorMaterial(black: .black)
}
}
}