Beatmup::NNets::Storage::Scanner Class Reference

Scans a storageview in RAM for further computations on CPU. More...

#include <storage.h>

Public Member Functions
	Scanner ()
	Scanner (Storage::View &view)
	~Scanner ()
void	bind (Storage::View &view)
	Binds a view to the scanner. More...
void	unbind ()
	Unbinds the current view from the scanner. More...
void	move (int x, int y)
	Sets the pointer to a specific spatial position. More...
Scanner &	operator++ ()
	Advances pointer by one pixel in scanline order (along the horizontal axis). More...
template<typename T >
void	fill (T begin, T limit)
	Extracts the content of feature maps at the current position. More...

Protected Types
typedef uint8_t	sample_t[4]
	four unsigned 8-bit scalars More...

Protected Attributes
Storage::View *	view
	a view to sample More...
sample_t **	ptr
	pointers at current position per channel More...
size_t	ptrSize
sample_t *	data
	the texture data pointer More...

Detailed Description

Scans a storageview in RAM for further computations on CPU.

A piece of an ancient civilization technology used when neural networks were still inferred with CPU.

Definition at line 466 of file storage.h.

Member Typedef Documentation

sample_t

typedef uint8_t Beatmup::NNets::Storage::Scanner::sample_t[4]

protected

four unsigned 8-bit scalars

Definition at line 468 of file storage.h.

Constructor & Destructor Documentation

Scanner() [1/2]

Beatmup::NNets::Storage::Scanner::Scanner ( )

inline

Definition at line 475 of file storage.h.

: view(nullptr), ptr(nullptr), ptrSize(0) {}

Scanner() [2/2]

Beatmup::NNets::Storage::Scanner::Scanner ( Storage::View &  view )

inline

Definition at line 476 of file storage.h.

: Scanner() { bind(view); }

~Scanner()

Storage::Scanner::~Scanner

(

)

Definition at line 632 of file storage.cpp.

                         {
    if (ptr)
        delete[] ptr;
}

Member Function Documentation

bind()

void Storage::Scanner::bind

(

Storage::View &

view

)

Binds a view to the scanner.

Definition at line 638 of file storage.cpp.

                                           {
#ifdef BEATMUP_DEBUG
    DebugAssertion::check(!this->view, "A view is already bound");
    DebugAssertion::check(view.storage->memory, "Storage is not allocated in RAM");
#endif
    // set internal state
    this->view = &view;
    if (view.channels.size() != ptrSize || !ptr) {
        if (ptr)
            delete[] ptr;
        ptrSize = view.channels.size();
        ptr = new sample_t*[ptrSize];
    }
 
    // acquire memory
    data = view.storage->memory.ptr<sample_t>();
}

unbind()

void Storage::Scanner::unbind

(

)

Unbinds the current view from the scanner.

Definition at line 657 of file storage.cpp.

                            {
    if (view)
        view = nullptr;
}

move()

void Storage::Scanner::move	(	int	x,
		int	y
	)

Sets the pointer to a specific spatial position.

Parameters

[in]	x	horizontal position in pixels
[in]	y	vertical position in pixels

Definition at line 663 of file storage.cpp.

                                      {
    const Storage& storage = *view->storage;
    const int
        w = storage.getTextureWidth(),
        h = storage.getTextureHeight();
    for (size_t i = 0; i < ptrSize; ++i) {
        const IntPoint pos = view->getChannelOrigin(4 * i) + IntPoint(x, y);
        const int storageTexNum = view->textures[view->channels[i].textureIdx];
        ptr[i] = data + ((storageTexNum * h + pos.y) * w + pos.x);
    }
}

operator++()

Storage::Scanner & Storage::Scanner::operator++

(

)

Advances pointer by one pixel in scanline order (along the horizontal axis).

Definition at line 676 of file storage.cpp.

                                           {
    size_t i = 0;
#ifdef BEATMUP_ENABLE_NEON
    if (sizeof(void*) == 8) {
        i += ptrSize / 2 * 2;
        auto _1 = vdupq_n_u64(sizeof(sample_t*));
        uint64_t* p = (uint64_t*)ptr;
        const uint64_t* stop = p + i;
        for (; p < stop; p += 2)
            vst1q_u64(p, vaddq_u64(vld1q_u64(p), _1));
    }
    else if (sizeof(void*) == 4) {
        i += ptrSize / 4 * 4;
        auto _1 = vdupq_n_u32(sizeof(sample_t*));
        uint32_t* p = (uint32_t*)ptr;
        const uint32_t* stop = p + i;
        for (; p < stop; p += 4)
            vst1q_u32(p, vaddq_u32(vld1q_u32(p), _1));
    }
#endif
    for (; i < ptrSize; ++i)
        ++ptr[i];
 
    return *this;
}

fill()

template<typename T >

void Beatmup::NNets::Storage::Scanner::fill ( T  begin, T  limit  )

inline

Extracts the content of feature maps at the current position.

Accepts iterators of floating point STL containers, e.g. std::vector<float>::begin() and std::vector<float>::end().

Parameters

[in]	begin	Iterator to copy to
[in]	limit	Limiting iterator position. If reached, no more samples are copied.

Definition at line 508 of file storage.h.

                                                   {
                    size_t i = 0;
                    const float factor = 1.0f / 255;
                    for (T it = begin; it != limit && i < ptrSize; ++i) {
                        *it++ = factor * (*ptr[i])[0];
                        if (it == limit) return;
                        *it++ = factor * (*ptr[i])[1];
                        if (it == limit) return;
                        *it++ = factor * (*ptr[i])[2];
                        if (it == limit) return;
                        *it++ = factor * (*ptr[i])[3];
                    }
                }

Member Data Documentation

view

Storage::View* Beatmup::NNets::Storage::Scanner::view

protected

a view to sample

Definition at line 469 of file storage.h.

ptr

sample_t** Beatmup::NNets::Storage::Scanner::ptr

protected

pointers at current position per channel

Definition at line 470 of file storage.h.

ptrSize

size_t Beatmup::NNets::Storage::Scanner::ptrSize

protected

Definition at line 471 of file storage.h.

data

sample_t* Beatmup::NNets::Storage::Scanner::data

protected

the texture data pointer

Definition at line 472 of file storage.h.

---

The documentation for this class was generated from the following files:

• core/nnets/storage.h
• core/nnets/storage.cpp