aardgoose / CaveView.js

Web native 3d cave survey viewer
https://aardgoose.github.io/CaveView.js/
MIT License
44 stars 11 forks source link

Documentation #10

Open ariaveta opened 6 years ago

ariaveta commented 6 years ago

Hello, I'd like to understand how to enable by default some features like showing terrain and map overlay shading.

Any hint? Any example? Thanks

aardgoose commented 6 years ago

Hi,

I need to document terrain creation, do you have a survey/area in mind?

If you could provide an example survey - preferably a survex .3d model with the coordinate reference system defined using the '*CS OUT" command, I can document the process for you.

Adding overlays is relatively simple when terrain data is available.

ariaveta commented 6 years ago

Hello, I meant not creation of 3d models. I simply need to show terrain by default in Caveview. I already have some 3d models, you can see them here:

http://www.speleotoscana.it/programmi_php_mm/caveview.html

You can enable terrain and shadowing and also a map.

But I need terrain and shadowing enabled as the user opens the page, without being forced to use settings menu. I guess it's only a matter to set some javascript variables, but I found no examples about that.

Thanks

aardgoose commented 6 years ago

Hi,

OK, I see what you want, It is not possible in a reliable way at the moment, however should be very simple to add, it was something I had planned to do.

I'll sort this out.

aardgoose commented 6 years ago

Hi,

You can now set initial view settings with the latest version. The 1.4.0 release notes give an example of this. Examples of the properties of the view object can be seen in the script that drives the display on the project home page:

https://github.com/aardgoose/CaveView.js/blob/gh-pages/CaveView/lib/demoscript.js

ariaveta commented 6 years ago

Hello. great job, thanks!

aardgoose commented 6 years ago

Hi,

The latest version (1.5.0) now has much better wall rendering for .lox models

ariaveta commented 6 years ago

Thanks, we used 1.5 on our website (unfortunately it's in Italian):

http://www.speleotoscana.it/3d/

You can explore 3D models of some caves in Tuscany.

Just a little note: if you set HUD: true in initial settings HUD don't get displayed, but the radio button is selected. If you cycle the radio button, you get HUD.

aardgoose commented 6 years ago

Hi,

Nice looking models....

I'll take a look at the HUD issue - the initial display setting needs some revision. The next version will use much less memory.

If you are interested I will look at making it possible to add alternative languages for the menus.

ariaveta commented 6 years ago

Hello, thanks for your email.

Yes, I'm interested and, of course, I can translate it in Italian.

Ciao.

2018-01-19 18:19 GMT+01:00 aardgoose notifications@github.com:

Hi,

Nice looking models....

I'll take a look at the HUD issue - the initial display setting needs some revision. The next version will use much less memory.

If you are interested I will look at making it possible to add alternative languages for the menus.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/aardgoose/CaveView.js/issues/10#issuecomment-359032404, or mute the thread https://github.com/notifications/unsubscribe-auth/ACLZD7fTBjF9_yMO0b0_PkFR7Uz8CAqQks5tMM6ggaJpZM4RJFSK .

ariaveta commented 6 years ago

Hello, could you please provide a bit of documentation about new features usage?

Thanks.

I noticed map overlay in our models is not enabled by default in 1.6 but it was in 1.5. Here's the initial settings we use:

view: {   section: 0,   entrances: false,   cameraType: CV.CAMERA_ORTHOGRAPHIC,   box: false,   terrain: true,   view: CV.VIEW_ELEVATION_E,   shadingMode: CV.MAP_OVERLAY,   terrainShading: CV.SHADING_OVERLAY,   walls: true,   HUD: false,   autoRotate: false,   autoRotateRate: 1.0,   stations: false,   stationLabels: false,   fullscreen: false   }

aardgoose commented 6 years ago

Hi, the overlay not showing is a bug I've introduced. Fix coming soon Documentation of language etc to come (a bit busy at the moment)

aardgoose commented 6 years ago

In case you haven't noticed I have added some quick info on the language translation mechanism.

ariaveta commented 6 years ago

I admit not to have seen those info.

Where can I find them?

Thanks

2018-03-08 12:08 GMT+01:00 aardgoose notifications@github.com:

In case you haven't noticed I have added some quick info on the language translation mechanism.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/aardgoose/CaveView.js/issues/10#issuecomment-371456496, or mute the thread https://github.com/notifications/unsubscribe-auth/ACLZD0dyg4idTXdzonPvjfqW7LxMOa_vks5tcREegaJpZM4RJFSK .

aardgoose commented 6 years ago

(linked from the demo page)

https://aardgoose.github.io/CaveView.js/translation.html

MaticDiba commented 5 years ago

Hi, this really looks awesome.

Is it possible to make detailed tutorial?

I have terrain images (geotiff) available. If I understand correctly it is also possible to use some tile provider like OSM?

The issue I have it, that terrain image is in different CRS. So I am a bit lost how to solve this.

I can provide terrain image and .3d file if that would help.

Othervise, this plugin really rocks :)

aardgoose commented 5 years ago

Hi,

Thanks, I know the documentation needs improving. If you can provide a terrain file and .3d file that would be great. I can use that as a test case to document the process of creating height tiles. I can handle CRS conversion and will document that.

For the terrain image overlays I have used Bing/OSM and some WMTS providers, again this needs documenting properly.

MaticDiba commented 5 years ago

Hi, thanks for fast respond. I've uploaded a zip to wetransfer. There is survex project included with img file that represents terrain image. I'm not sure if that is what is needed for terrain generation in CaveView. Other then that I can provide .asc files for that area (one example is in ExampleOfAsci folder).

If there is anything else that I can help with, just let me know. Also regarding helping making tutorial/example. I'm just stuck at this point of how to use terrain image that I have right now.

CRS that I use are in .svx file.

Thanks for your help.

aardgoose commented 5 years ago

Hi, Thanks, does the DTM use the same CRS as the Survex data? It looks like it does.

MaticDiba commented 5 years ago

Yes it does. I didn't manage to get this info with dtm (I'm still learning the awesome stuff in GIS world :)).

I got .asc file from our national agency, and created .tiff with SAGA GIS, so I was able to use it in qGis.

aardgoose commented 5 years ago

I've made a small set of tiles to cover your example cave.

You can drag and drop onto the demo site at https://aardgoose.github.io/CaveView.js/fulldemo.html

It looks right to me, the tiff doesn't quite cover the region but looks like a match to the images on katasterjam.si.

Just got to write up the procedure now.

I use a third GIS product to create the tiles, GRASS GIS which you probably have because it comes bundled with QGIS.

MaticDiba commented 5 years ago

Hi, sorry I don't quite underatan where tiles are :)

By the way ... I used CaveView on katasterjam, so users can just upload 3d to a cave or multiple caves, and then dynamically display it with CaveView: https://www.katasterjam.si/Caves/Details/10904#dokumenti

I was thinking of creating tiles for uploaded 3d with a service in a cloud. But I will see if that could be automated.

MaticDiba commented 5 years ago

Hi, I tested my model on your demo website. It seems like it works.

I guess now, I will just have to figure it out how to use las or asc files and convert them into tiles with grass library.

I must say, CaveView really is an awesome library! Thumbs up!!!

aardgoose commented 5 years ago

Hi,

I have put up some documentation for tile creation here.

Hope this is useful and let me known about any errors in the docs.

Cheers

MaticDiba commented 5 years ago

I read the documentation and it's clear what I have to do. I think there is a typo in "tilecreation.html", where you mention "ESPG:3875" CRS, but I think it's 3875. But it's not a big deal.

The other thing is, I tried to use Cesium (I signed up and used my own apikey) and it seems to work with provided examples of surveys. But when I tried to use my own survey, left menu bar is not rendered. If I drag it to https://aardgoose.github.io/CaveView.js/fulldemo.html it works (menu bar is displayed). This is the project I was playing with.

Oh, and the link to cesiumtiles.html is dead.

aardgoose commented 5 years ago

Hi,

when the menu bar doesn't come up, its probably an error which isn't handled well. If you can point me to a demo of this I can take a look. The first place is the javascript console in the browser, although if you use the minimized builds the error information will be rather cryptic.