Difference Between `fitBounds` and `fitBoundsWithConstraints` in OpenSeadragon (OSD)

(The following is a response from ChatGPT. I hope it serves as a helpful reference.)

The difference between fitBounds and fitBoundsWithConstraints in OpenSeadragon (OSD) lies in whether or not constraints are applied.

OSD is a JavaScript library with advanced zoom and panning capabilities, used for handling deeply zoomable images and content. Among its methods, fitBounds and fitBoundsWithConstraints are used to fit the viewport (display area) to specific bounds.

fitBounds(rectangle, immediately): Fits the viewport to the specified rectangle. If the immediately parameter is true, the viewport fits instantly without animation. If false, the viewport fits with animation.

fitBoundsWithConstraints(rectangle, immediately): Performs the same action as fitBounds, but takes into account the viewport’s zoom and pan constraints. That is, before fitting to the specified rectangle, it checks the minimum zoom level, maximum zoom level, image pan constraints, etc. This ensures that even when users zoom or pan the image, the set constraints are never exceeded.

In other words, the main difference is that fitBoundsWithConstraints applies viewport constraints, preventing any behavior that exceeds those constraints. This is particularly important for controlling the behavior when users zoom in/out or pan (scroll) images.