Todo List

Member rolmodl::geom::RectWH::RectWH (const int argX, const int argY, const int argW, const int argH) noexcept

Replace ints with rolmodl::geom::Pos and rolmodl::geom::Size? It's less convenient to initialize.

Member rolmodl::geom::RectXY::RectXY (const int argX, const int argY, const int argX1, const int argY1) noexcept

Replace ints with rolmodl::geom::Pos? It's less convenient to initialize

Class rolmodl::geom::XYFloats

what are the units here?

any other uses?

Class rolmodl::geom::XYInt32

any other uses?

Member rolmodl::Ren::clipRect () noexcept

What is the difference between clipping being disabled and the rectangle not being set yet.

Member rolmodl::Ren::drawLine (const geom::Pos a, const geom::Pos b)

needs ContigousIterators, for which no check can be done at compile-time also needs SDL_Point structs, or byte-equivalent reinterpret_cast geom::Point?

Member rolmodl::Ren::fillScreen ()

Rename to fillTarget

How is this functionally different from clear()?

Class rolmodl::ren::Flags

todo: some flags might be mutually exclusive fixme: how does CreateSoftwareRenderer relate

Member rolmodl::Ren::getBlendMode ()

Verify that textures indeed ignore this.

Member rolmodl::Ren::getRealSize ()

Explain how to use this with resolution-independent rendering.

Member rolmodl::ren::Info::name

add examples

Member rolmodl::Ren::isClipOn () noexcept

What is the difference between clipping being disabled and the rectangle not being set yet.

not clear if false is an error state because the docs suggest "call `SDL_GetError()` for more information." if SDL_FALSE is returned.

Member rolmodl::Ren::logicalSize () noexcept

Explain how to use this with resolution-independent rendering.

Member rolmodl::Ren::outlineScreen ()

Rename to outlineTarget

Member rolmodl::Ren::present () noexcept

How does this work with non-window rendering targets?

Member rolmodl::Ren::scale () noexcept

Explain how to use this, including with resolution-independent rendering.

Member rolmodl::Ren::setBlendMode (const BlendMode m)

Verify that textures indeed ignore this.

Member rolmodl::Ren::setLogicalSize (const geom::Size s)

Explain how to use this with resolution-independent rendering.

Member rolmodl::Ren::setScale (const RenScale s)

Explain how to use this, including with resolution-independent rendering.

Member rolmodl::Ren::viewport () noexcept

How does this work? Does it scale? Clip?

Explain how to use this, including with resolution-independent rendering.

Class rolmodl::sys::Display

: explain why a snapshot is used instead of separate functions

Member rolmodl::sys::display::mode::unsafe::closestForDisplayN (unsigned int n, const DisplayMode ideal)

: what does that equal in terms of pixelfmt::Id, the doc said it needs to be 0

Class rolmodl::sys::pwr::Status

: explain why a snapshot is used instead of separate functions

Member rolmodl::TexRen::setDefaultTarget ()

What specifically is the default rendering target?

Member rolmodl::TexRen::unsafeGetTarget () noexcept

Implement a class that does this safely?

Class rolmodl::win::Flags

fixme: no support for some window flags i dont understand todo: some flags are mutually exclusive

Member rolmodl::win::Flags::isOpengl () const noexcept

add a "see also" on something about OpenGL.

Member rolmodl::win::Flags::withOpengl () const noexcept

add a "see also" on something about OpenGL.