Fs Image

Este nuevo tipo de campo se puede utilizar de la misma forma que el tipo de campo 'Image' de odoo.

from odoo import models
from odoo.addons.fs_image.fields import FSImage

class MyModel(models.Model):
    _name = 'my.model'

    image = FSImage('Image', max_width=1920, max_height=1920)

<record id="my_model_form" model="ir.ui.view">
    <field name="name">my.model.form</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <field name="image" class="oe_avatar"/>
                </group>
            </sheet>
        </form>
    </field>
</record>

En el ejemplo anterior, la imagen se redimensionará a 1920x1920px si es más grande que eso. El widget utilizado en la vista de formulario también permitirá al usuario establecer un texto 'alt' para la imagen.

Un ejemplo más avanzado y útil es el siguiente:

from odoo import models
from odoo.addons.fs_image.fields import FSImage

class MyModel(models.Model):
    _name = 'my.model'

    image_1920 = FSImage('Image', max_width=1920, max_height=1920)
    image_128 = FSImage('Image', max_width=128, max_height=128, related='image_1920', store=True)

<record id="my_model_form" model="ir.ui.view">
    <field name="name">my.model.form</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <field
                        name="image_1920"
                        class="oe_avatar"
                         options="{'preview_image': 'image_128', 'zoom': true}"
                     />
                </group>
            </sheet>
        </form>
    </field>
</record>

En el ejemplo anterior tenemos dos campos, uno para la imagen original y otro para una miniatura. Como la miniatura se define como un campo relacionado almacenado, se genera automáticamente a partir de la imagen original, se redimensiona al tamaño indicado y se almacena en la base de datos. La miniatura se utiliza entonces como imagen de vista previa de la imagen original en la vista de formulario. La principal ventaja de este enfoque es que la imagen original no se carga en la vista de formulario y se utiliza la miniatura en su lugar, que es mucho más pequeña en tamaño y más rápida de cargar. La opción 'zoom' permite al usuario ver la imagen original en una ventana emergente al hacer clic en la miniatura.

Por comodidad, el módulo 'fs_image' también proporciona una clase mixin 'FSImageMixin' que se puede utilizar para añadir los campos 'image' e 'image_medium' a un modelo. Solo define la miniatura medium como una imagen de 128x128px, ya que es el caso de uso más común. Cuando se utiliza un campo de imagen en un modelo, se recomienda utilizar esta clase mixin para asegurar que el campo 'image_medium' esté siempre definido. Una buena práctica es utilizar el campo image_medium como imagen de vista previa del campo image en la vista de formulario para evitar sobrecargar la vista de formulario con una imagen grande y consumir demasiado ancho de banda.

from odoo import models

class MyModel(models.Model):
    _name = 'my.model'
    _inherit = ['fs_image.mixin']

<record id="my_model_form" model="ir.ui.view">
    <field name="name">my.model.form</field>
    <field name="model">my.model</field>
    <field name="arch" type="xml">
        <form>
            <sheet>
                <group>
                    <field
                        name="image"
                        class="oe_avatar"
                        options="{'preview_image': 'image_medium', 'zoom': true}"
                    />
                </group>
            </sheet>
        </form>
    </field>
</record>