client: rework and document opacity field