Update README.md

This commit is contained in:
Rick Companje 2021-05-30 22:44:54 +02:00 committed by GitHub
parent b45e3ccae7
commit c0cc500c0e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,73 +1,20 @@
# Doodle3D-App # Doodle3D-App
Doodle3D Transform is a free and open-source web-app that makes designing in 3D easy and fun! Created with love by Casper, Peter, Rick, Nico, Jeroen, Simon, Donna and Arne. With the support of 1,626 Kickstarter backers. Doodle3D Transform is a free and open-source web-app that makes designing in 3D easy and fun! Created with love by Casper, Peter, Rick, Nico, Jeroen, Simon, Donna and Arne in 2015-2017. With the support of 1,626 Kickstarter backers.
In 2021 we changed the app to work completely on the client-side. There is no server sided-code and/or user management anymore.
As of 2021-05-26 Doodle3D Transform is distributed under the MIT License. This gives everyone the freedoms to use Doodle3D Transform in any context: commercial or non-commercial, public or private, open or closed source. As of 2021-05-26 Doodle3D Transform is distributed under the MIT License. This gives everyone the freedoms to use Doodle3D Transform in any context: commercial or non-commercial, public or private, open or closed source.
![Screenshot](screenshot.png) ![Screenshot](screenshot.png)
## Prerequisites ## Run online
- Install [Node.js](https://nodejs.org/en/) v6 LTS (v8 is not supported yet). https://doodle3d.com
- Update NPM to at least v5.
`$ npm install npm@latest -g`
## Install ## Build & run locally
- Clone our repo. ```bash
`$ git clone git@github.com:Doodle3D/Doodle3D-App.git` git clone git@github.com:Doodle3D/Doodle3D-Transform.git
- Go into it. cd Doodle3D-Transform
`$ cd Doodle3D-App` npm install
- Install all dependencies npm run start
`$ npm install` # visit http://localhost:8080
- Setup environment variables, see below.
## Run
Start the server, you can visit it at http://localhost:8080
``` ```
npm start
```
## Create distribution
To create a optimized version of our app that's ready for deployment run:
```
npm run dist
```
To test this distribution start our app in production mode by running:
```
npm run start-production
```
## Build & Run as App
[Cordova](https://cordova.apache.org/) is used to build the app. Before building with Cordova, it needs to be installed.
```
npm run cordova:install
```
- **Run iOS** (mac only)
Build app and deploy to ios device:
`npm run ios`
- **Emulate iOS** (mac only)
Build app and start iOS emulator:
`npm run ios-emulate [-- -{platform}]`
- **Run Android**
Build app and deploy on device or emulator:
`npm run android`
- **Run Windows** (win only)
Build app and deploy on device:
`npm run windows`
## Import / Export dev tool
In `Developer tools` > `Console`:
- `files.exportFile(name)`
- `name`: name of file to export
```
files.exportFile('star')
```
- `files.importFile(data, name)`
- `data`: result of `exportFile` between single quotes
- `name`: override name of file (optionally)
```
files.importFile('{"data":[{"height":40,"transform":{"metadata":{"library":"CAL","type":"Matrix"},"matrix":[1,0,-7.73286467486821,0,1,18.980667838312854]},"sculpt":[1,1,1],"cut":[true,true],"twist":0,"type":"STAR","star":{"rays":5,"innerRadius":25,"outerRadius":53}}],"_attachments":{"img":{"content_type":"image/jpeg","digest":"md5-NOT2LxdCerpIrG/7vEczDw==","length":7442,"stub":true}},"_id":"star","_rev":"3-6ea2bc9e62628a25078d9d8d90aff151"}','imported star')
```
- `files.loadAllNames()`
Get a list of the names all saves sketches