Additional tutorial entries for code snippets

[veggiesaurus]

Additional tutorial entries are needed for the following:

• Changing FoV, channels and Stokes of images
• Adjusting render config
• Creating regions

@kswang1029 may have more suggestions on what to add after testing out the code snippets feature in more detail

[veggiesaurus]

moving this and #1482 to the final 3.0 beta milestone, as it is low-risk

[keflavich]

Bump - are there any existing tools for loading regions?

[veggiesaurus]

Bump - are there any existing tools for loading regions?

@keflavich you can load regions into the current active image using

await app.importRegion(directory, filename, regionType);

where regionType is the region type enum value. CRTF = 1 and DS9 = 2.

[keflavich]

perfect, thank you!

Related: is there a delete for regions? If I open a region file that has 100x, say, is there a scripty way to delete them?

[veggiesaurus]

perfect, thank you!

Related: is there a delete for regions? If I open a region file that has 100x, say, is there a scripty way to delete them?

This might be a bit slow for 100 regions (it will do a filter for each deletion, so it probably O(N²). I'd like to add a .clearRegions function too, because this is probably quite a common use case):

for (const region of app.activeFrame.regionSet.regions) {
    app.activeFrame.regionSet.deleteRegion(region);
}

[keflavich]

yes, I think there are a lot of different region-related functions that could use additional support, and I'd be happy to expand on them somewhere if you'd like - but I suspect you guys have a checklist somewhere?

Anyway, thanks, this will work at least to clear out regions without clicking a ton.

[veggiesaurus]

yes, I think there are a lot of different region-related functions that could use additional support, and I'd be happy to expand on them somewhere if you'd like - but I suspect you guys have a checklist somewhere?

Anyway, thanks, this will work at least to clear out regions without clicking a ton.

Feel free to send me a list of requested functions/tutorials/etc. Quite a few might already be easily done.