Skip to content

Commit

Permalink
docs: announce cientos 3.4.0 (#405)
Browse files Browse the repository at this point in the history
* docs: announce cientos 3.4.0

* docs: add damian contribution

* docs: add fix grammar, add image inline-examples in cientos

* Update docs/blog/announcing-cientos-3-4-0.md

* Update docs/blog/announcing-cientos-3-4-0.md

* chore: apply suggestions from code review

---------

Co-authored-by: Alvaro Saburido <[email protected]>
  • Loading branch information
JaimeTorrealba and alvarosabu authored Sep 26, 2023
1 parent 838d779 commit 193b4ed
Show file tree
Hide file tree
Showing 6 changed files with 110 additions and 0 deletions.
110 changes: 110 additions & 0 deletions docs/blog/announcing-cientos-3-4-0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
---
sidebar: false
---

# Announcing cientos v3.4.0 🎉

Cientos is here again with a new and exiting release 🎉.

- **Cientos v3.4.0**

<iframe src="https://giphy.com/embed/2XOL4zsm6V0nm" width="480" height="358" frameBorder="0" class="giphy-embed" allowFullScreen></iframe><p><a href="https://giphy.com/gifs/walking-2XOL4zsm6V0nm">via GIPHY</a></p>

## LensFlare

A new and completely original abstraction has arrived to Cientos ✨ Behold His Majesty `<LensFlare />`.

It's a wrapper of the Three.js [LensFlare](https://threejs.org/docs/#examples/en/objects/Lensflare) addon.

![](/blog/lensflare.gif)

While it could look intimidating at first, this component has a lot of flexibility, so check out all the different options [here](https://cientos.tresjs.org/guide/abstractions/lensflare.html)

We're going to say thanks to [andretchen0](https://github.com/andretchen0) for this incredible contribution.

## Sky

The `Sky` component allows you to create realistic outdoor scenes with the use of sky, which as the name implies creates sky gradients and more with just a few lines of code.

![](/blog/sky.gif)

This is fancy wrapper of the addon [Sky](https://threejs.org/examples/?q=sky#webgl_shaders_sky).

```vue
<script setup lang="ts">
import { Sky } from '@tresjs/cientos'
</script>
<template>
<TresCanvas>
<TresPerspectiveCamera :position="[0, 100, 2000]" />
<Sky />
</TresCanvas>
</template>
```
Could it be simpler?

You can find the official docs [here](https://cientos.tresjs.org/guide/staging/sky.html)

Another one of [andretchen0](https://github.com/andretchen0) amazing contributions!

## SVG

![](/blog/svg.gif)

A classical one, the svg loader component has arrived in cientos this release, to bring the versatility of `svg` into a wrapper of the original [loader](https://threejs.org/docs/?q=svg#examples/en/loaders/SVGLoader) with basically one line of code (well two if you count the import 😅).

```html
<template>
<TresCanvas>
<Suspense>
<SVG src="/favicon.svg" /> // you can pass a path or a inline svg
</Suspense>
</TresCanvas>
</template>
```
You can find the official docs [here](https://cientos.tresjs.org/guide/loaders/svg.html).

And yes, again big thanks to [andretchen0](https://github.com/andretchen0) 3 in a row!

## Stats-gl

![](/blog/stats-gl.png)


Another exciting one is the addition of Stats-gl which is like statsjs but with superpowers, originally developed by [RenaudRohlinger](https://github.com/RenaudRohlinger/stats-gl) is a powerful performance monitoring tool.

```vue
<script setup lang="ts">
import { TresCanvas } from '@tresjs/core'
import { StatsGl } from '@tresjs/cientos'
</script>
<template>
<TresCanvas>
<StatsGl /> // as simple as this
</TresCanvas>
</template>
```

Big thanks to [notarun](https://github.com/notarun) for this contribution.

Official docs [here](https://cientos.tresjs.org/guide/misc/stats-gl.html).

## Fix camera as a param problem in controls

[damiankoper](https://github.com/damiankoper) discovered a bug when you tried to use the camera as a parameter.

Thanks to [damiankoper](https://github.com/damiankoper) for this useful contribution.

## New documentation full of examples

![](/blog/docs-examples.png)

In addition to all these amazing new features, we have been working internally to improve the UX, and now you can visit the [cientos](https://cientos.tresjs.org/) page and navigate through the components and see the inline examples right away.

## Internal organization of code (will be easier to contribute)

Also, we're constantly working on the DX: refactors, cleaning, and internal improvement. So now we have a clear structure, now it is easier than ever to contribute to the cientos package 😁.

Thanks for reading and happy 3D coding 😊.
Binary file added docs/public/blog/docs-examples.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/blog/lensflare.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/blog/sky.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/blog/stats-gl.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/blog/svg.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 193b4ed

Please sign in to comment.